home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / diz2p100.zip / DIZ-2PCB.DOC < prev    next >
Text File  |  1993-06-15  |  9KB  |  242 lines
  1.  
  2.  
  3.        ▀█▀▀▄  █   █▀▀▀▀▀█    ▄▀ ▄▀▀▀▀▀▄        ▀█▀▀▄   ▄▀▀▀▄ ▀█▀▀▄
  4.         █   █  █      ▄▀    ▄▀   ▀   ▄▀         █   █ █       █   █
  5.         █   █  █    ▄▀     ▄▀      ▄▀    ▀▀▀▀  ▀█▀▀▀  █      ▀█▀▀▀█
  6.         █   █  █  ▄▀    ▄ ▄▀     ▄▀   ▄         █     █       █   █
  7.        ▄▀▄▄▄▀  ▀▄ ▀▀▀▀▀▀▀       ▀▀▀▀▀▀▀        ▀      ▀▄▄▄▄▀ ▀ ▀▀▀
  8.  
  9.  
  10.                                DIZ/2 PCB
  11.                (C)opyright 1993, written by Shawn Reimerdes
  12.                     FILE_ID.DIZ eXtractor for PCBoard
  13.                     Anti-Christ Software Designs Inc.
  14.                               $5 Shareware
  15.  
  16. ┌────────────────────────────────┐
  17. │░ Brief Features ░░░░░░░░░░░░░░░│
  18. └────────────────────────────────┘
  19.  
  20.       ■ FILE_ID.DIZ Inserting.
  21.       ■ Supports  ZIP, ARJ, LZH, PAK.
  22.       ■ Local DOS command line uploading to a dir file.
  23.       ■ Logs processing info to PCBoard's caller log.
  24.       ■ Creates archive comments with file information.
  25.       ■ Configurable "diz plus".
  26.       ■ Deletes BBSAds quickly.
  27.  
  28.        
  29. ┌────────────────────────────────┐
  30. │░ Introduction ░░░░░░░░░░░░░░░░░│
  31. └────────────────────────────────┘
  32.  
  33.    The reason I wrote this was because there are NO good DIZ inserting
  34.  utilities out for PCBoard. The only ones that are around screw with the
  35.  DIZ, for example PCBDESC wordwraps everything :(, so this utility leaves
  36.  the DIZ as-is.
  37.    DIZ/2-PCB is a command line utility for PCBoard. It scans an uploaded
  38.  archive for a file named "FILE_ID.DIZ" and if found, uses the text 
  39.  to replace any description typed by the user and also adds: # of files, 
  40.  oldest and newest file dates, uncompressed size. It also handles local 
  41.  uploads and will post a file with a DIZ that was intended to be private as
  42.  a private file with a DIZ.
  43.    I recommend that you use the most current versions of your achiving
  44.  utilities. If you want an achive type added in the current support, leave
  45.  me a message and I'll add it for ya.
  46.    DIZ/2-PCB will remove BBSAds as well. Since its already looking to see 
  47.  if a DIZ is there why not check for BBSAds as well? I highly suggest using 
  48.  this feature, its surprisingly fast. If any of the ads you listed were
  49.  found it runs pkzip to delete them.
  50.  
  51.     ■ Archivers
  52.       Supported: ZIP, ARJ, LZH, PAK.
  53.       Tested with: Pkzip v2.04x, Arj v2.x, Lharc v2.x, Pak v2.51.
  54.  
  55. ┌────────────────────────────────┐
  56. │░ Samples ░░░░░░░░░░░░░░░░░░░░░░│
  57. └────────────────────────────────┘           
  58.   
  59.  description:
  60.  
  61.      | DIZ/2-PCB v1.00 of 06.15.93 - PCBoard utility to
  62.      | extract FILE_ID.DIZ in ZIP/ARJ/LZH/PAK files,
  63.      | adds the # of files, newest/oldest file dates
  64.      | and the uncompressed size. Local Uploading.
  65.      | Removes unwanted BBSAds, archive comment 
  66.      | generator. The fastest and most powerful
  67.      | processor out! Shareware by Shawn Reimerdes.
  68.      | Files: 10  New: 06.03.93  Old: 06.20.93 φ DIZ
  69.      | Uncompressed Size: 34,820 bytes
  70.   
  71.  
  72.  caller log:
  73.  
  74.   **************************************************************
  75.   02-25-93 (23:15) (2) JOHN SMITH (16800E) (G) NEW YORK, NY
  76.         Connect type: CONNECT 16800/ARQ/HST/HST/V42BIS          
  77.         Directory Scan for (930221) ... (Ctrl-K) aborts         
  78.         DIZ/2 v1.05 of 2.25.92 by Shawn Reimerdes               
  79.         ■ Processing file: filename1.zip                         
  80.          - Files: 7 New: 02.26.93 Old: 01.21.93                   
  81.          - FILE_ID.DIZ found.                                    
  82.          √ BBSAd: (CALL.ME) removed.
  83.         1 files,  1,437k bytes,  29.8 minutes,  1709.5 cps,  118
  84.         (U) FILENAME1.ZIP Completed using G  T/E=0  CPS=1,707    
  85.         Upload Time Credit:  10 minutes                         
  86.         Pascal Conference Joined.                           
  87.         Minutes Used: 38                                        
  88.   02-25-93 (23:52) (2) JOHN SMITH Off Normally                     
  89.   **************************************************************
  90.  
  91.  
  92.  exiting errorlevels:
  93.  
  94.             29 = DIZ Found.
  95.             1  = Error.
  96.             0  = Sucessful, No DIZ found.
  97.  
  98.  
  99. ┌────────────────────────────────┐
  100. │░ How to use properly ░░░░░░░░░░│
  101. └────────────────────────────────┘
  102.  
  103.   Sample line from PCBTEST.BAT:
  104.  
  105.     diz-2pcb c:\diz2pcb\diz-2pcb.cnf %1 %3  
  106.                                       ^  ^                      
  107.                                       |  |                      
  108.                                filename   path/name fdesc
  109.  
  110.   Dos command line for LOCAL uploading. If file doesn't contain FILE_ID.DIZ,
  111.   then you will be asked to enter a description.
  112.   If DIZ/2 finds a 5th parameter it assumes a local upload:
  113.  
  114.     diz-pcb2 diz-2pcb.cnf filename.zip c:\pcb\gen\uplddir /L
  115.                             ^                 ^            ^ 
  116.                             |                 |            |
  117.                       filename    directory to post file   Indicates local
  118.  
  119.  
  120.  Note: (Check batch files included with this package)                    
  121.  
  122. ┌────────────────────────────────┐
  123. │░ Archive Comment ░░░░░░░░░░░░░░│
  124. └────────────────────────────────┘           
  125.  
  126.     If you have a registered version of DIZ/2PCB you will be able to create
  127.   a file that will contain variables to be translated, so that you can use
  128.   it as the comment for your archived file.
  129.     Simply create a textfile (path/name in config) any variables from the
  130.   list below will be translated and a new textfile will be created with
  131.   values in place of the %'s. After the program is done you can execute
  132.   a program to add a the newly created comment into the archive.
  133.  
  134.   variables:
  135.        
  136.        %a - archive type
  137.        %d - system date
  138.        %n - newest filedate
  139.        %o - oldest filedate
  140.        %s - size of file
  141.        %t - system time
  142.        %v - DIZ/2PCB version
  143.        %# - number of files
  144.        %1 - filename
  145.        %2 - FILE_ID.DIZ description (if found)
  146.        %3 - node number
  147.  
  148.   example:
  149.    
  150.    ░▒▓ Filename: %1 - %a
  151.    ░▒▓ Uploaded on %d at %t to A Clockwork Orange BBS 
  152.    ░▒▓ Files: %#  Newest: %n  Oldest: %o  Size: %s
  153.    ░▒▓ %2
  154.    ░▒▓ ■ Via DIZ/2-PCB %v
  155.  
  156.  
  157. ┌────────────────────────────────┐
  158. │░ External Diz Plus ░░░░░░░░░░░░│
  159. └────────────────────────────────┘           
  160.   
  161.   If you want to change the look of the: | Files:  New:  Old: φ DIZ
  162.                                          | Uncompressed Size:  bytes
  163.  
  164.     Make a file as defined in the config anyway you like and use the
  165.   macros listed below to fill in the correct information. If you do
  166.   use it you should turn off the standard two lines it normally adds.
  167.  
  168.         %a - archive type
  169.         %u - uncompressed size
  170.         %i - if diz found "φ DIZ"
  171.         %d - system date
  172.         %t - system time
  173.         %# - number of files
  174.         %n - newest file date
  175.         %o - oldest file date
  176.         %v - diz/2 version number
  177.         %3 - node number
  178.  
  179.         %^ - beginning of line
  180.         %~ - end of line
  181.  
  182.  
  183.   example:
  184.  
  185.     %^│Files: %#  Newest: %n  Oldest: %o%i%~
  186.     %^│Uncompressed Size: %u  Node %3%~
  187.  
  188. ┌────────────────────────────────┐
  189. │░ DIZ-2.CNF ░░░░░░░░░░░░░░░░░░░░│
  190. └────────────────────────────────┘           
  191.  
  192.  
  193.  Example:
  194.  
  195.  Shawn Reimerdes
  196.  000000
  197.  YES
  198.  YES
  199.  YES
  200.  C:\DIZ2PCB\ADS.LST
  201.  NONE
  202.  NONE
  203.  
  204.  -----------
  205.   Line  1 - SysOp's Name. Used to append to descriptions you upload locally.
  206.   Line  2 - Registration #.
  207.   Line  4 - add "Files: X  Old: XX.XX.XX  New: XX.XX.XX" line? (YES/NO)
  208.   Line  5 - add "Uncompressed Size: X bytes" line? (YES/NO)
  209.   Line  6 - Delete BBSAds from achive? 
  210.   Line  7 - Path/Name of BBSAds List that need removal.
  211.             The list should be a list of filenames. One filename per line.
  212.     
  213.             <DIZ2-ADS.LST>    FUCKBBS.AD
  214.                               -------*.*
  215.                               CALLME.*
  216.                               THEBBS.TXT
  217.  
  218.             DIZ-2 will check these filenames with the ZIP achive its checking
  219.             and if found will run PKZIP to delete them. Very Fast.
  220.  
  221.   *Line 8 - Path/Name of archive comment to be translated. NONE=off. The newly
  222.             created file will be the same name but the extension will be .@@@
  223.             (ex: DIZ2-COM.TXT => DIZ2-COM.@@@)
  224.    Line 9 - Path/Name of external diz plus (see docs). NONE=off
  225.   
  226.  *=Registered feature
  227.  
  228. ┌────────────────────────────────┐
  229. │░ Author's Notes ░░░░░░░░░░░░░░░│
  230. └────────────────────────────────┘           
  231.  
  232.    I'll be releasing any new versions when time allows, if there are requests
  233.  those features will be added as soon as possible.
  234.  
  235.    If there's any confusion about this product (because of my horrible docs)
  236.  or any questions/problems - you can leave me mail on Salt Air BBS.
  237.  
  238.  
  239.    
  240. Thanks for your support and pass the word on,
  241.  -- Shawn Reimerdes.
  242.